TrackWindowProxyDrag

TrackWindowProxyDrag
Header:	MacWindows.h		Carbon status:	Supported

Handles all aspects of the drag process when the user drags a proxy icon.

OSStatus TrackWindowProxyDrag (
    WindowRef window, 
    Point startPt
);

window: A pointer to the window whose proxy icon is being dragged.
startPt: Set the Point structure to contain the point, specified in global coordinates, where the mouse-down event that began the drag occurred. Your application may retrieve this value from the where field of the event structure.

function result: A result code. If you receive the error errUserWantsToDragWindow (–5607), your application should respond by calling the Window Manager function DragWindow. Errors are also returned from the Drag Manager, including userCanceledErr (–128).

DISCUSSION

If your application uses proxy icons to represent a type of object (currently, file system entities such as files, folders, and volumes) supported by the Window Manager, your application should call the TrackWindowProxyDrag function, and the Window Manager can handle all aspects of the drag process for you. If your application calls the TrackWindowProxyDrag function, it does not have to call the Drag Manager function WaitMouseMoved before starting to track the drag, as the Window Manager handles this automatically. However, if a proxy icon represents a type of data that the Window Manager does not support, or if you wish to implement custom dragging behavior, your application should call the function TrackWindowProxyFromExistingDrag.

Your application detects that a user is dragging one of its proxy icons when the function FindWindow returns the inProxyIcon result code; see “FindWindow Result Code Constant for the Proxy Icon” for more details.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when WindowsLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by WindowsLib 8.5 and later.